package pers.xiaojun.boot.module.system.service.dept;

import com.baomidou.mybatisplus.extension.service.IService;
import pers.xiaojun.boot.module.system.controller.dept.vo.dept.DeptQueryReqVO;
import pers.xiaojun.boot.module.system.controller.dept.vo.dept.DeptSaveReqVO;
import pers.xiaojun.boot.module.system.dao.entity.dept.DeptDO;

import java.util.List;

/**
 * 部门服务类
 *
 * @author xiaojun
 * @since 2025-11-01
 */
public interface DeptService extends IService<DeptDO> {

    /**
     * 创建部门
     *
     * @param saveVO 部门信息
     * @return 部门
     */
    DeptDO saveDept(DeptSaveReqVO saveVO);

    /**
     * 更新部门
     *
     * @param updateVO 部门信息
     * @return 部门
     */
    DeptDO updateDept(DeptSaveReqVO updateVO);

    /**
     * 根据部门Id删除部门
     *
     * @param deptId 部门Id
     */
    void removeDeptById(Long deptId);

    /**
     * 根据一批部门Id删除部门
     *
     * @param deptIds 部门Id列表
     */
    void removeDeptByIds(List<Long> deptIds);

    /**
     * 根据部门Id获取部门
     *
     * @param deptId 部门Id
     * @return 部门
     */
    DeptDO getDeptById(Long deptId);


    /**
     * 获取部门列表（条件查询）
     *
     * @param queryVO 查询条件
     * @return 部门列表
     */
    List<DeptDO> listDepts(DeptQueryReqVO queryVO);

    /**
     * 检查部门状态是否开启（抛出业务异常）
     *
     * @param deptId 部门Id
     * @return 部门信息
     */
    DeptDO validateDeptIsEnabled(Long deptId);
}
